Exception Handling এবং Logging

Exception Handling কী?

Exception Handling হল প্রোগ্রামিংয়ের একটি গুরুত্বপূর্ণ অংশ যা কোড চলাকালীন সময়ে যেকোনো ধরনের ত্রুটি বা ব্যতিক্রম (exception) সঠিকভাবে পরিচালনা করতে সাহায্য করে। স্প্রিং বুট অ্যাপ্লিকেশনে Exception Handling ব্যবহৃত হয় ডাটাবেসের অপারেশন, সার্ভিস বা কন্ট্রোলারের মধ্যে যেকোনো ত্রুটি হ্যান্ডেল করার জন্য।

স্প্রিং বুট JPA (Java Persistence API) ব্যবহার করার সময়, বিশেষত ডেটাবেস অ্যাক্সেসের সময় ব্যতিক্রম ঘটতে পারে, যেমন:

• ডেটাবেসে সংযোগ না থাকা
• ডুপ্লিকেট ইনসার্ট
• রেকর্ড না পাওয়া
• কাস্টম কুয়েরি ত্রুটি ইত্যাদি।

এগুলো হ্যান্ডেল করার জন্য স্প্রিং বুটে @ControllerAdvice, @ExceptionHandler, এবং @ResponseStatus ব্যবহার করা হয়।

Spring Boot JPA Exception Handling

স্প্রিং বুট অ্যাপ্লিকেশনে Exception Handling এর জন্য @ControllerAdvice ক্লাস ব্যবহার করা হয়, যেখানে আপনি গ্লোবালি বা নির্দিষ্ট কন্ট্রোলারে ব্যতিক্রম হ্যান্ডেল করতে পারেন। এছাড়াও, @ExceptionHandler অ্যানোটেশন ব্যবহারের মাধ্যমে নির্দিষ্ট ব্যতিক্রমের জন্য মেথড তৈরি করা যায়।

উদাহরণ: Exception Handling in Spring Boot JPA

ধরা যাক, আমাদের একটি User Entity এবং একটি UserRepository ইন্টারফেস রয়েছে। আমরা যদি কোনো ব্যবহারকারীকে ডাটাবেস থেকে খুঁজে না পাই, তখন আমরা একটি কাস্টম ব্যতিক্রম (Exception) তৈরি করব এবং সেটি হ্যান্ডেল করব।

Step 1: User Entity ক্লাস তৈরি করা

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String name;
    private String email;

    // Constructor, Getters, and Setters
    public User(String name, String email) {
        this.name = name;
        this.email = email;
    }

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

Step 2: কাস্টম Exception তৈরি করা

public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException(String message) {
        super(message);
    }
}

এখানে আমরা UserNotFoundException নামে একটি কাস্টম Exception তৈরি করেছি, যা ডাটাবেসে ব্যবহারকারী না পাওয়ার ক্ষেত্রে ব্যবহার হবে।

Step 3: UserRepository ইন্টারফেস তৈরি করা

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    User findByName(String name);
}

Step 4: UserService ক্লাস তৈরি করা

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public User getUserByName(String name) {
        User user = userRepository.findByName(name);
        if (user == null) {
            throw new UserNotFoundException("User with name " + name + " not found");
        }
        return user;
    }
}

Step 5: UserController ক্লাস তৈরি করা

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/user/{name}")
    public User getUser(@PathVariable String name) {
        return userService.getUserByName(name);
    }
}

Step 6: Global Exception Handler (ControllerAdvice)

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ControllerAdvice;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFoundException(UserNotFoundException exception) {
        return new ResponseEntity<>(exception.getMessage(), HttpStatus.NOT_FOUND);
    }
}

এখানে @ControllerAdvice ক্লাসটি ব্যবহার করা হয়েছে, যা গ্লোবালি ব্যতিক্রম হ্যান্ডেল করবে। যখন UserNotFoundException এক্সেপশন থ্রো হবে, তখন এটি একটি NOT_FOUND রেসপন্স পাঠাবে।

Spring Boot JPA Logging

Logging হল একটি গুরুত্বপূর্ণ অংশ যা অ্যাপ্লিকেশন ডেভেলপমেন্টে ডিবাগিং এবং মনিটরিং করার জন্য ব্যবহৃত হয়। স্প্রিং বুটে ডিফল্টভাবে SLF4J (Simple Logging Facade for Java) এবং Logback ব্যবহৃত হয়। এই লগিং ফ্রেমওয়ার্কগুলির মাধ্যমে আপনি সহজেই লগ তৈরি করতে পারেন এবং অ্যাপ্লিকেশন রানটাইমে গুরুত্বপূর্ণ তথ্য সংগ্রহ করতে পারেন।

উদাহরণ: Spring Boot Application-এ Logging যোগ করা

স্প্রিং বুট অ্যাপ্লিকেশনে লগিং ব্যবহারের জন্য, আপনি org.slf4j.Logger ব্যবহার করবেন।

Step 1: Logging কোড যোগ করা

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private static final Logger logger = LoggerFactory.getLogger(UserService.class);

    @Autowired
    private UserRepository userRepository;

    public User getUserByName(String name) {
        logger.info("Fetching user with name: {}", name); // Log the action
        User user = userRepository.findByName(name);
        if (user == null) {
            logger.error("User with name {} not found", name); // Log an error if user not found
            throw new UserNotFoundException("User with name " + name + " not found");
        }
        return user;
    }
}

Step 2: application.properties ফাইলে লগিং কনফিগারেশন

স্প্রিং বুটের লগিং কনফিগারেশন সাধারণত application.properties ফাইলে রাখা হয়। এখানে আপনি লগিং লেভেল এবং আউটপুট ফরম্যাট কনফিগার করতে পারেন।

# Set logging level to INFO
logging.level.org.springframework=INFO
logging.level.com.example=DEBUG

# Set log file path
logging.file.name=app.log

এখানে:

• INFO লেভেলে লগ হবে স্প্রিং ফ্রেমওয়ার্কের জন্য।
• DEBUG লেভেলে আপনার অ্যাপ্লিকেশনের জন্য লগ হবে।
• লোগগুলি একটি app.log ফাইলে সেভ হবে।

Conclusion

Exception Handling এবং Logging দুটি অত্যন্ত গুরুত্বপূর্ণ ফিচার যা Spring Boot JPA অ্যাপ্লিকেশনের পারফরম্যান্স এবং নির্ভরযোগ্যতা নিশ্চিত করতে সাহায্য করে:

1. Exception Handling ব্যবহার করে আপনি অ্যাপ্লিকেশনে ত্রুটির সঠিক এবং সহজ সমাধান দিতে পারেন এবং ব্যবহারকারীর জন্য একটি পরিষ্কার এবং নির্ভরযোগ্য API সরবরাহ করতে পারেন।
2. Logging ব্যবহার করে আপনি অ্যাপ্লিকেশনের কার্যকলাপ মনিটর করতে পারেন, ডিবাগিং করতে পারেন এবং অ্যাপ্লিকেশন চলাকালীন যেকোনো গুরুত্বপূর্ণ তথ্য লোগে রাখতে পারেন।

এই দুইটি ফিচার অ্যাপ্লিকেশন ডেভেলপমেন্টের জন্য অপরিহার্য এবং আপনার অ্যাপ্লিকেশনকে আরো শক্তিশালী এবং রিলায়েবল করে তোলে।

Spring Boot JPA Exception Handling হল Spring Boot অ্যাপ্লিকেশনগুলিতে ডেটাবেস অপারেশনের সময় সঠিকভাবে ত্রুটি বা এক্সসেপশন হ্যান্ডলিং পরিচালনা করার পদ্ধতি। Spring Data JPA এবং Hibernate-এ ডেটাবেস অ্যাক্সেসের সময় বিভিন্ন ধরনের এক্সসেপশন (যেমন SQL Exception, DataIntegrityViolationException, EntityNotFoundException ইত্যাদি) হতে পারে, এবং সেগুলোকে যথাযথভাবে পরিচালনা করা প্রয়োজন।

Spring Boot JPA Exception Handling এর মাধ্যমে আপনি ডেটাবেস অপারেশনগুলোতে সঠিক ত্রুটি বা এক্সসেপশন হ্যান্ডলিং এবং ব্যবহারকারীকে সঠিক বার্তা প্রদান করতে পারেন।

Spring Data JPA Exception Types

Spring Data JPA-তে বিভিন্ন ধরনের এক্সসেপশন থাকে যা ডেটাবেস অপারেশন চলাকালীন ঘটতে পারে। কিছু সাধারণ এক্সসেপশন হল:

1. DataIntegrityViolationException:
   • এই এক্সসেপশনটি সাধারণত তখন ঘটে যখন ডেটাবেসে ডেটা ইনটিগ্রিটি (যেমন, ডুপ্লিকেট এন্ট্রি, কনস্ট্রেইন্ট ভায়োলেশন) লঙ্ঘন করা হয়।
   • উদাহরণস্বরূপ, একটি ইউনিক কনস্ট্রেইন্ট লঙ্ঘন করা হলে এই এক্সসেপশনটি শো হতে পারে।
2. EntityNotFoundException:
   • যখন কোনো Entity নির্দিষ্ট ID দ্বারা ডেটাবেসে খুঁজে পাওয়া যায় না, তখন এই এক্সসেপশনটি সৃষ্টি হয়।
3. JpaSystemException:
   • এটি Hibernate বা JPA সম্পর্কিত যে কোনো সিস্টেম ত্রুটি দ্বারা ঘটতে পারে।
4. QueryTimeoutException:
   • যখন কোনো কুয়েরি নির্দিষ্ট টাইম আউটের মধ্যে সম্পন্ন হতে ব্যর্থ হয়, তখন এই এক্সসেপশনটি সৃষ্টি হয়।
5. ConstraintViolationException:
   • এই এক্সসেপশনটি সাধারণত তখন ঘটে যখন ডেটাবেস কনস্ট্রেইন্ট লঙ্ঘিত হয় (যেমন, ফোরেন কির রেফারেন্স ভায়োলেশন)।

Spring Boot JPA Exception Handling এর ধারণা

Spring Boot অ্যাপ্লিকেশনগুলিতে এক্সসেপশন হ্যান্ডলিং করার জন্য সাধারণত @ControllerAdvice, @ExceptionHandler এবং @ResponseStatus অ্যানোটেশনগুলি ব্যবহার করা হয়। এছাড়া Spring Data JPA-তে @Transactional ব্যবহার করে ট্রানজ্যাকশনাল এক্সসেপশন হ্যান্ডলিংও করা যায়।

১. @ControllerAdvice এবং @ExceptionHandler ব্যবহার করা

@ControllerAdvice একটি গ্লোবাল এক্সসেপশন হ্যান্ডলার হিসেবে কাজ করে এবং @ExceptionHandler নির্দিষ্ট এক্সসেপশনগুলো হ্যান্ডল করতে ব্যবহৃত হয়। আপনি এই দুটি অ্যানোটেশন ব্যবহার করে একটি কাস্টম এক্সসেপশন হ্যান্ডলিং কনফিগারেশন তৈরি করতে পারেন।

উদাহরণ:

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(DataIntegrityViolationException.class)
    public ResponseEntity<String> handleDataIntegrityViolation(DataIntegrityViolationException ex) {
        return new ResponseEntity<>("Data integrity violation: " + ex.getMessage(), HttpStatus.BAD_REQUEST);
    }

    @ExceptionHandler(EntityNotFoundException.class)
    public ResponseEntity<String> handleEntityNotFound(EntityNotFoundException ex) {
        return new ResponseEntity<>("Entity not found: " + ex.getMessage(), HttpStatus.NOT_FOUND);
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleGenericException(Exception ex) {
        return new ResponseEntity<>("An error occurred: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

এখানে, @ControllerAdvice কনটেক্সটের মধ্যে সমস্ত কন্ট্রোলারের এক্সসেপশন হ্যান্ডল করার জন্য ব্যবহৃত হয়। handleDataIntegrityViolation, handleEntityNotFound, এবং handleGenericException মেথডগুলি বিভিন্ন ধরনের এক্সসেপশন হ্যান্ডল করবে।

২. @ResponseStatus অ্যানোটেশন

Spring Frameworkে @ResponseStatus অ্যানোটেশন ব্যবহার করে আপনি HTTP স্টেটাস কোড কাস্টমাইজ করতে পারেন যখন কোনো এক্সসেপশন হ্যান্ডল করা হয়। এটি বিশেষ করে RESTful API-তে গুরুত্বপূর্ণ।

উদাহরণ:

@ResponseStatus(HttpStatus.NOT_FOUND)
public class EntityNotFoundException extends RuntimeException {
    public EntityNotFoundException(String message) {
        super(message);
    }
}

এখানে, @ResponseStatus(HttpStatus.NOT_FOUND) HTTP 404 স্টেটাস কোড সেট করতে ব্যবহৃত হয়েছে, যখন EntityNotFoundException এক্সসেপশন থ্রো করা হয়।

Spring Boot JPA Exception Handling-এ Best Practices

1. Global Exception Handler:
   • @ControllerAdvice এবং @ExceptionHandler ব্যবহার করে একটি গ্লোবাল এক্সসেপশন হ্যান্ডলার তৈরি করুন, যা অ্যাপ্লিকেশনের সকল এক্সসেপশনকে সেন্ট্রালাইজডভাবে পরিচালনা করবে।
2. Custom Exception Class:
   • Custom Exception ক্লাস তৈরি করুন যাতে আপনি স্পেসিফিক এক্সসেপশন মেসেজ এবং HTTP স্টেটাস কোড কাস্টমাইজ করতে পারেন। যেমন, EntityNotFoundException, DataIntegrityViolationException ইত্যাদি।
3. Meaningful Error Messages:
   • কাস্টম এক্সসেপশনের মাধ্যমে স্পষ্ট এবং অর্থপূর্ণ ত্রুটি বার্তা প্রদান করুন, যাতে ব্যবহারকারী বা ডেভেলপার ত্রুটির কারণ বুঝতে পারে।
4. Transactional Integrity:
   • @Transactional ব্যবহারের মাধ্যমে ডেটাবেসের ট্রানজ্যাকশনাল এক্সসেপশন হ্যান্ডলিং করুন। এক্সসেপশন হ্যান্ডল করলে টান্সঅ্যাকশন রোলব্যাক করা উচিত, যাতে ডেটাবেসের ইনটিগ্রিটি বজায় থাকে।
5. Avoid Handling RuntimeException Globally:
   • RuntimeException এর মতো সাধারণ এক্সসেপশন গ্লোবালি হ্যান্ডল করার সময় সাবধান থাকুন, কারণ এই ধরনের এক্সসেপশন সাধারণত কোডের ভুল নির্দেশ করে।

সারাংশ

Spring Boot JPA Exception Handling হল একটি গুরুত্বপূর্ণ কৌশল যা Spring Boot অ্যাপ্লিকেশনে ডেটাবেস এক্সসেপশনগুলির সঠিক পরিচালনা নিশ্চিত করে। Spring Data JPA তে বিভিন্ন ধরনের এক্সসেপশন (যেমন, DataIntegrityViolationException, EntityNotFoundException) সাধারণত ঘটে থাকে, এবং এগুলিকে @ControllerAdvice, @ExceptionHandler, এবং @ResponseStatus ব্যবহার করে সঠিকভাবে হ্যান্ডল করা উচিত। এটি আপনার অ্যাপ্লিকেশনকে আরও স্থিতিশীল, রিলায়েবল এবং ব্যবহারকারী বান্ধব করে তোলে।

Exception Handling স্প্রিং বুট অ্যাপ্লিকেশনগুলিতে অত্যন্ত গুরুত্বপূর্ণ, বিশেষত যখন ডেটাবেসের সাথে কাজ করা হয়, যেমন JPA (Java Persistence API) ব্যবহার করে ডেটাবেস অপারেশন। স্প্রিং বুটে Exception Handling করার জন্য @ExceptionHandler এবং @ControllerAdvice অ্যানোটেশন দুটি শক্তিশালী টুল সরবরাহ করে। এই অ্যানোটেশনগুলি ডেটাবেস সম্পর্কিত সমস্যাগুলির (যেমন ডেটা না পাওয়া বা ভ্যালিডেশন ত্রুটি) ক্ষেত্রে উপযুক্ত ত্রুটি বার্তা প্রদানে সহায়ক।

@ExceptionHandler এবং @ControllerAdvice

1. @ExceptionHandler: এই অ্যানোটেশনটি ক্লাসের মধ্যে ব্যবহার করা হয় এবং এটি শুধুমাত্র একটি নির্দিষ্ট এক্সসেপশন টাইপের জন্য ব্যবহৃত হয়। এটি একটি বিশেষ মেথডকে চিহ্নিত করে যা স্প্রিং এমভিসি কন্ট্রোলার ক্লাসে এক্সসেপশন হ্যান্ডেল করার জন্য ব্যবহার করা হয়।
2. @ControllerAdvice: এটি একটি বৈশিষ্ট্য যা স্প্রিং ফ্রেমওয়ার্কে ব্যবহৃত হয় এবং এটি একাধিক কন্ট্রোলারে সাধারণ এক্সসেপশন হ্যান্ডলিং কার্যকর করার জন্য ব্যবহৃত হয়। এটি একটি গ্লোবাল এক্সসেপশন হ্যান্ডলার তৈরি করতে সহায়ক, যার মাধ্যমে অ্যাপ্লিকেশনের যেকোনো কন্ট্রোলারের জন্য এক্সসেপশন হ্যান্ডল করা সম্ভব।

@ExceptionHandler এবং @ControllerAdvice এর ব্যবহার

Step ১: Entity ক্লাস

ধরা যাক, আমাদের একটি Employee টেবিলের জন্য একটি Entity ক্লাস তৈরি আছে:

@Entity
public class Employee {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String department;
    private double salary;

    // Getters and Setters
}

Step ২: Repository তৈরি

স্প্রিং ডেটা জেপিএ ব্যবহার করে Repository তৈরি করা হয়।

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface EmployeeRepository extends JpaRepository<Employee, Long> {
    Employee findById(long id);
}

এখানে, findById মেথডটি Employee টেবিল থেকে একটি নির্দিষ্ট কর্মচারী খুঁজে বের করবে।

Step ৩: Service ক্লাস

Service ক্লাসে Repository ইনজেক্ট করে ডেটাবেস অপারেশন করা হয়।

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class EmployeeService {

    @Autowired
    private EmployeeRepository employeeRepository;

    public Employee getEmployeeById(long id) {
        return employeeRepository.findById(id)
                .orElseThrow(() -> new EmployeeNotFoundException("Employee not found with id: " + id));
    }
}

এখানে, যদি Employee মডেল না পাওয়া যায়, তবে একটি কাস্টম এক্সসেপশন EmployeeNotFoundException ছোড়া হবে।

Step ৪: কাস্টম এক্সসেপশন তৈরি করা

এখানে একটি কাস্টম এক্সসেপশন EmployeeNotFoundException তৈরি করা হয়েছে:

public class EmployeeNotFoundException extends RuntimeException {
    public EmployeeNotFoundException(String message) {
        super(message);
    }
}

এই এক্সসেপশনটি EmployeeService ক্লাসে ব্যবহার করা হয়েছে, যেখানে ডেটা না পাওয়া গেলে এটি ছোড়া হবে।

Step ৫: @ExceptionHandler ব্যবহার করা

@ExceptionHandler অ্যানোটেশনটি ব্যবহার করে, আপনি একটি নির্দিষ্ট এক্সসেপশন হ্যান্ডল করতে পারেন:

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(EmployeeNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public String handleEmployeeNotFoundException(EmployeeNotFoundException ex) {
        return ex.getMessage();
    }
}

এখানে, @ExceptionHandler(EmployeeNotFoundException.class) ব্যবহার করা হয়েছে। এটি EmployeeNotFoundException এক্সসেপশনটি হ্যান্ডল করবে এবং HttpStatus.NOT_FOUND (404) স্ট্যাটাস সহ একটি বার্তা রিটার্ন করবে।

Step ৬: @ControllerAdvice ব্যবহার করা

@ControllerAdvice অ্যানোটেশনটি গ্লোবাল এক্সসেপশন হ্যান্ডলিংয়ের জন্য ব্যবহৃত হয়। এটি একটি ক্লাসের উপরে বসিয়ে সমস্ত কন্ট্রোলারগুলির জন্য এক্সসেপশন হ্যান্ডলিং বাস্তবায়ন করা হয়।

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(EmployeeNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public String handleEmployeeNotFoundException(EmployeeNotFoundException ex) {
        return ex.getMessage();
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public String handleGeneralException(Exception ex) {
        return "An unexpected error occurred: " + ex.getMessage();
    }
}

এখানে, @ControllerAdvice অ্যানোটেশনটি সমস্ত কন্ট্রোলারের জন্য গ্লোবাল এক্সসেপশন হ্যান্ডলিং করছে। handleEmployeeNotFoundException মেথডটি EmployeeNotFoundException এক্সসেপশন হ্যান্ডল করে, এবং handleGeneralException মেথডটি অন্যান্য সাধারণ এক্সসেপশন হ্যান্ডল করে।

Step ৭: Controller ক্লাস

স্প্রিং Controller ক্লাসে ডেটা রিট্রিভ করার জন্য EmployeeService মেথড কল করা হয়।

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EmployeeController {

    @Autowired
    private EmployeeService employeeService;

    @GetMapping("/employees/{id}")
    public Employee getEmployeeById(@PathVariable long id) {
        return employeeService.getEmployeeById(id);
    }
}

এখানে, EmployeeController ক্লাসে EmployeeService ক্লাসের getEmployeeById মেথড কল করা হয়েছে, যা id এর ভিত্তিতে কর্মচারী খুঁজে বের করবে। যদি কর্মচারী পাওয়া না যায়, তবে EmployeeNotFoundException ছোড়া হবে এবং সেই অনুযায়ী GlobalExceptionHandler এক্সসেপশন হ্যান্ডল করবে।

@ExceptionHandler এবং @ControllerAdvice এর সুবিধা

1. গ্লোবাল এক্সসেপশন হ্যান্ডলিং: @ControllerAdvice ব্যবহারের মাধ্যমে পুরো অ্যাপ্লিকেশনে এক্সসেপশন হ্যান্ডল করা যায়। এটি একই ধরনের এক্সসেপশন হ্যান্ডল করার জন্য একটি সাধারণ স্থান সরবরাহ করে।
2. কাস্টম এক্সসেপশন বার্তা: আপনি কাস্টম এক্সসেপশন তৈরি করতে পারেন এবং ব্যবহারকারীদের জন্য একটি পরিষ্কার এবং স্পষ্ট বার্তা প্রদর্শন করতে পারেন।
3. ডেটাবেস বা সার্ভার সংক্রান্ত ত্রুটির জন্য কার্যকর সমাধান: @ExceptionHandler এবং @ControllerAdvice ব্যবহার করে ডেটাবেস সম্পর্কিত ত্রুটিগুলি (যেমন EntityNotFoundException, ConstraintViolationException) বা সার্ভার ত্রুটি সহজেই হ্যান্ডল করা যায়।
4. কোড পরিষ্কার রাখা: এক্সসেপশন হ্যান্ডলিং এক্সক্লুসিভভাবে এক্সসেপশন হ্যান্ডলার ক্লাসে রাখতে পারেন, যা কোডকে পরিষ্কার এবং মেইনটেনেবল রাখে।

উপসংহার

স্প্রিং বুটের @ExceptionHandler এবং @ControllerAdvice অ্যানোটেশনগুলি ব্যবহার করে সহজেই এক্সসেপশন হ্যান্ডলিং করা যায়। এটি কাস্টম এক্সসেপশন এবং সাধারণ এক্সসেপশন উভয়ই হ্যান্ডল করার জন্য শক্তিশালী উপায় সরবরাহ করে। @ExceptionHandler একটি নির্দিষ্ট কন্ট্রোলার বা মেথডের জন্য এক্সসেপশন হ্যান্ডল করে, যেখানে @ControllerAdvice গ্লোবালি সমস্ত কন্ট্রোলারের জন্য এক্সসেপশন হ্যান্ডল করতে সহায়ক।

Spring Boot JPA ব্যবহার করার সময় Exception Handling এবং Logging অত্যন্ত গুরুত্বপূর্ণ, কারণ এটি অ্যাপ্লিকেশনের ডিবাগিং এবং ত্রুটি সনাক্তকরণে সাহায্য করে। Spring Boot এর মাধ্যমে আপনি সহজে exception handling এবং logging পরিচালনা করতে পারেন, যা আপনার অ্যাপ্লিকেশনকে আরও স্থিতিশীল এবং ট্রেসযোগ্য করে তোলে। নিচে Exception Handling এবং Logging এর ধারণা এবং উদাহরণ দেওয়া হয়েছে।

1. Exception Handling in Spring Boot JPA

Spring Boot JPA-তে exception handling মূলত @ControllerAdvice এবং @ExceptionHandler অ্যানোটেশন ব্যবহার করে করা হয়। এর মাধ্যমে আপনি ডেটাবেস অপারেশন বা অন্যান্য অপারেশন চলাকালীন যেকোনো ধরনের ত্রুটি (exceptions) সেন্ট্রালি হ্যান্ডেল করতে পারেন।

উদাহরণ: Exception Handling with @ControllerAdvice and @ExceptionHandler

Step 1: Custom Exception Class

প্রথমে একটি কাস্টম exception ক্লাস তৈরি করুন যা ডেটাবেস বা অন্যান্য অপারেশনগুলির ত্রুটি নির্ধারণে সাহায্য করবে।

public class ProductNotFoundException extends RuntimeException {
    public ProductNotFoundException(String message) {
        super(message);
    }
}

Step 2: Service Layer with Exception Handling

ধরা যাক, ProductService ক্লাসে আমরা ProductNotFoundException কাস্টম exception থ্রো করব যখন কোনও পণ্য ডাটাবেসে পাওয়া না যায়।

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.Optional;

@Service
public class ProductService {

    @Autowired
    private ProductRepository productRepository;

    public Product getProductById(Long id) {
        Optional<Product> product = productRepository.findById(id);
        if (product.isPresent()) {
            return product.get();
        } else {
            throw new ProductNotFoundException("Product not found with id: " + id);
        }
    }
}

Step 3: Global Exception Handler with @ControllerAdvice

এখন, আমরা @ControllerAdvice ব্যবহার করে একটি global exception handler তৈরি করব, যা অ্যাপ্লিকেশন জুড়ে যে কোন exception হ্যান্ডেল করবে।

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ControllerAdvice;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ProductNotFoundException.class)
    public ResponseEntity<String> handleProductNotFoundException(ProductNotFoundException ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
    }

    // Handle other exceptions
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleGenericException(Exception ex) {
        return new ResponseEntity<>("Internal Server Error", HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

এখানে, @ControllerAdvice গ্লোবালি সমস্ত exception হ্যান্ডল করতে ব্যবহৃত হচ্ছে এবং @ExceptionHandler নির্দিষ্ট exception (যেমন ProductNotFoundException) হ্যান্ডল করছে।

Step 4: Controller Layer

এখন, আমরা ProductController ক্লাসে ProductService এর মাধ্যমে একটি পণ্য খুঁজে বের করার চেষ্টা করব এবং যদি পণ্য না পাওয়া যায়, তবে কাস্টম exception ফেলা হবে।

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProductController {

    @Autowired
    private ProductService productService;

    @GetMapping("/products/{id}")
    public Product getProductById(@PathVariable Long id) {
        return productService.getProductById(id);
    }
}

এখন, যদি আপনি /products/1 রিকোয়েস্ট করেন এবং সেই id তে কোনো পণ্য না থাকে, তবে ProductNotFoundException হ্যান্ডল হবে এবং একটি 404 Not Found রেসপন্স ফিরিয়ে দিবে।

2. Logging in Spring Boot JPA

Logging হল অ্যাপ্লিকেশনের কার্যকলাপ ট্র্যাক করার একটি গুরুত্বপূর্ণ উপায়। Spring Boot সাধারণভাবে SLF4J (Simple Logging Facade for Java) এবং Logback (Spring Boot এর জন্য ডিফল্ট logging ফ্রেমওয়ার্ক) ব্যবহার করে।

উদাহরণ: Logging in Spring Boot

Step 1: Add Dependencies (If Needed)

Spring Boot ডিফল্টভাবে SLF4J এবং Logback ব্যবহার করে, তবে আপনি যদি অন্য কোন logging ফ্রেমওয়ার্ক ব্যবহার করতে চান, তবে পমে ডিপেনডেন্সি যোগ করতে পারেন।

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-logging</artifactId>
</dependency>

Step 2: Add Logging in Service Layer

Spring Boot-এ SLF4J logger ব্যবহার করতে আপনি LoggerFactory ক্লাসের মাধ্যমে logger তৈরি করতে পারেন এবং কাস্টম লগ বার্তা লিখতে পারেন।

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class ProductService {

    private static final Logger logger = LoggerFactory.getLogger(ProductService.class);

    @Autowired
    private ProductRepository productRepository;

    public Product getProductById(Long id) {
        logger.info("Fetching product with id: {}", id);
        Optional<Product> product = productRepository.findById(id);
        if (product.isPresent()) {
            logger.info("Product found: {}", product.get().getName());
            return product.get();
        } else {
            logger.error("Product not found with id: {}", id);
            throw new ProductNotFoundException("Product not found with id: " + id);
        }
    }
}

Step 3: Configure Logging Level (Optional)

Spring Boot-এ application.properties বা application.yml ফাইলের মাধ্যমে লগিং লেভেল কনফিগার করা যায়।

# Set logging level for the application
logging.level.com.example=DEBUG

# Set root logging level
logging.level.root=INFO

এখানে, com.example প্যাকেজের জন্য লগ লেভেল DEBUG করা হয়েছে এবং root লগ লেভেল INFO করা হয়েছে।

Step 4: View Logs

Spring Boot-এর ডিফল্টভাবে Logback কনফিগারেশনের মাধ্যমে, আপনি লগগুলি console-এ দেখতে পারবেন। আপনি চাইলে কনফিগারেশন ফাইল ব্যবহার করে লগ ফাইলও তৈরি করতে পারেন।

সারাংশ

Exception Handling এবং Logging Spring Boot JPA-এর গুরুত্বপূর্ণ অংশ যা অ্যাপ্লিকেশনের কার্যকারিতা এবং স্থিতিশীলতা নিশ্চিত করতে সাহায্য করে। Exception Handling এর মাধ্যমে আপনি ডেটাবেস বা অন্যান্য অপারেশনে ঘটে যাওয়া ত্রুটিগুলি সঠিকভাবে হ্যান্ডল করতে পারেন, এবং Logging এর মাধ্যমে অ্যাপ্লিকেশনের কার্যকলাপ ট্র্যাক করতে পারেন। Spring Boot এর @ControllerAdvice এবং @ExceptionHandler এর মাধ্যমে Exception Handling এবং SLF4J এর মাধ্যমে Logging সহজে এবং কার্যকরীভাবে পরিচালনা করা সম্ভব।